Scenario #9313: Newly Created Account for Existing Natural Person Should Be Able to View Existing Memberships

Properties

Required

Given

name value
subjectName xyz-peter.smith

Expected

name value
expectedMembershipsJson [
  {
    “partner”: {
      “partnerNumber”: “P-10002”,
      “partnerRel”: {
        “type”: “PARTNER”,
        “anchor”: { “tradeName”: “Hostsharing eG” },
        “holder”: { “tradeName”: “Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.” },
        “contact”: { “emailAddresses”: { “main”: “contact-admin@secondcontact.example.com” } }
      },
      “details”: {
        “registrationOffice”: “Hamburg”,
        “registrationNumber”: “RegNo123456789”
      }
    },
    “memberNumber”: “M-1000202”,
    “memberNumberSuffix”: “02”,
    “validFrom”: “2022-10-01”,
    “validTo”: “2025-12-31”,
    “status”: “CANCELLED”,
    “membershipFeeBillable”: true
  }
]

personUuid

HTTP GET "/api/hs/accounts/accounts" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
  "person" : {
    "uuid" : "bfecf1fc-b92b-47ae-aa84-9d52b57457ef", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "subject" : {
    "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
    "name" : "xyz-peter.smith",
    "type" : "USER"
  },
  "globalUid" : 21011,
  "globalGid" : 21011
} ]

Fetch the account for the current subject to resolve the related person.

Resolve partner trade name

HTTP GET "/api/hs/office/relations?relationType=REPRESENTATIVE&personUuid=bfecf1fc-b92b-47ae-aa84-9d52b57457ef" // personUuid \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "0a5c8f85-fbe0-4fce-8282-3da014b27d8f",
  "anchor" : {
    "uuid" : "65eac828-db90-482d-ad56-e95329e1b82f",
    "personType" : "LEGAL_PERSON",
    "tradeName" : "Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.",
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "holder" : {
    "uuid" : "bfecf1fc-b92b-47ae-aa84-9d52b57457ef", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "c888c87c-85dd-474c-83e4-22b833c2bead",
    "caption" : "second contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@secondcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
} ]

Resolve partner UUID

HTTP GET "/api/hs/office/partners?name=Peter+Smith+-+The+Second+Hand+and+Thrift+Stores-n-Shipping+e.K." \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "af954c5f-4d55-4990-a8e0-20129a11f54b",
  "partnerNumber" : "P-10002",
  "partnerRel" : {
    "uuid" : "f07df1d9-3427-4da5-a5c0-68252538d1fa",
    "anchor" : {
      "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa",
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "65eac828-db90-482d-ad56-e95329e1b82f",
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.",
      "salutation" : null,
      "title" : null,
      "givenName" : "Peter",
      "familyName" : "Smith"
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "c888c87c-85dd-474c-83e4-22b833c2bead",
      "caption" : "second contact",
      "postalAddress" : {
        "country" : "Germany"
      },
      "emailAddresses" : {
        "main" : "contact-admin@secondcontact.example.com"
      },
      "phoneNumbers" : {
        "phone_office" : "+49 123 1234567"
      }
    }
  },
  "details" : {
    "uuid" : "f25db7a5-b8d1-4e3e-92f1-d2dfd8a9a158",
    "registrationOffice" : "Hamburg",
    "registrationNumber" : "RegNo123456789",
    "birthName" : null,
    "birthPlace" : null,
    "birthday" : null,
    "dateOfDeath" : null
  }
} ]

View their memberships

HTTP GET "/api/hs/office/memberships?partnerUuid=af954c5f-4d55-4990-a8e0-20129a11f54b" // partnerUuid \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "ace726d8-adfe-40bc-9adb-ad7a700f9843",
  "partner" : {
    "uuid" : "af954c5f-4d55-4990-a8e0-20129a11f54b", // partnerUuid
    "partnerNumber" : "P-10002",
    "partnerRel" : {
      "uuid" : "f07df1d9-3427-4da5-a5c0-68252538d1fa",
      "anchor" : {
        "uuid" : "bb7b76f1-1922-46aa-8c22-468c70c3a9fa",
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "65eac828-db90-482d-ad56-e95329e1b82f",
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.",
        "salutation" : null,
        "title" : null,
        "givenName" : "Peter",
        "familyName" : "Smith"
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "c888c87c-85dd-474c-83e4-22b833c2bead",
        "caption" : "second contact",
        "postalAddress" : {
          "country" : "Germany"
        },
        "emailAddresses" : {
          "main" : "contact-admin@secondcontact.example.com"
        },
        "phoneNumbers" : {
          "phone_office" : "+49 123 1234567"
        }
      }
    },
    "details" : {
      "uuid" : "f25db7a5-b8d1-4e3e-92f1-d2dfd8a9a158",
      "registrationOffice" : "Hamburg",
      "registrationNumber" : "RegNo123456789",
      "birthName" : null,
      "birthPlace" : null,
      "birthday" : null,
      "dateOfDeath" : null
    }
  },
  "mainDebitor" : null,
  "memberNumber" : "M-1000202",
  "memberNumberSuffix" : "02",
  "validFrom" : "2022-10-01",
  "validTo" : "2025-12-31",
  "status" : "CANCELLED",
  "membershipFeeBillable" : true
} ]

generated on 2026-07-17 01:42:20 for branch